跳到主要内容

pay.trans.{outTradeNo}.update-extra

修改扩展信息

  • 请求路由: pay.trans.{outTradeNo}.update-extra
  • 交互模型: Request Response
  • 访问限制: 无

请求​

RSocket.rr({
"route" : "pay.trans.{outTradeNo}.update-extra",
"args" : {
"subOutTradeNo" : "CCO202311161153192837",
"extra" : {
"key1" : "value1",
"key2" : "value2"
},
"replace" : true
}
});

请求参数​

名称类型必须说明
outTradeNoString是订单编号
subOutTradeNoString否子订单编号,子订单有多个时必须提供提供
extraVaries是扩展信息内容
replaceBoolean否为true时,替换整个extra,否则合并新内容。默认为false

返回​

修改后的PrePsyRequest信息

{
"appId" : "XXXXXXXXXXXXXXXXXX",
"openId" : "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"outTradeNo" : "CCO202311161153192837",
"subOrders" : [
{
"subMchid" : "XXXXXXXXXX",
"description" : "深圳-香港",
"amount" : {
"total" : 10,
"currency" : "CNY"
},
"extra" : {
"key1" : "value1",
"key2" : "value2"
}
}
]
}

返回属性​

名称类型说明
spMchidString微信支付平台的服务商标识
该标识为微信支付平台合作伙伴或者普通商户标识。仅当明确需要指定特定服务商来提供微信支付功能时,提供该参数。
未提供时,依据配置根据当前请求的客户端应用自动选取;
appIdString付款应用ID
由微信生成的应用ID,全局唯一。请求基础下单接口时请注意AppID的应用属性,例如公众号场景下,需使用应用属性为公众号的服务号AppID
openIdString付款方在应用中的openId
payerInfoObject付款方的平台帐户信息
在非线上支付等场景时,需要提供该参数
payerInfo.targetTypeString帐户类型
由调用方根据分账方身份类型定义,例如:COMPANY,PARTNER,CHANNEL等
payerInfo.targetIdStringtargetType下的帐户标识
payerInfo.targetNameString帐户名
outTradeNoString商户系统内部订单号
只能是数字、大小写字母_-*且在同一个商户号下唯一。
subOrdersObject[]子订单列表
至少1个条目。当条目多于1个时,请求合单支付
subOrders.[].outTradeNoString子订单号
仅当子订单数超过1个时,提供该参数指定子订单编号,一般使用主订单编号加数字后缀组成,例如:CCO202311281608193004-1,CCO202311281608193004-2
subOrders.[].subMchidString二级商户标识
支付给二级商户时必填。
subOrders.[].payeeInfoObject收款方的平台帐户信息
subOrders.[].payeeInfo.targetTypeString帐户类型
由调用方根据分账方身份类型定义,例如:COMPANY,PARTNER,CHANNEL等
subOrders.[].payeeInfo.targetIdStringtargetType下的帐户标识
subOrders.[].payeeInfo.targetNameString帐户名
subOrders.[].descriptionString商品描述
subOrders.[].timeExpireString订单失效时间
subOrders.[].profitShareTargetsObject[]指定本次订单的分账方
subOrders.[].profitShareTargets.[].descriptionString分账的原因描述,分账账单中需要体现
最长80个字符
subOrders.[].profitShareTargets.[].amountNumber分账金额
仅当本次订单的分账金额与分账方配置不一致时提供
subOrders.[].profitShareTargets.[].manualSplitBoolean是否手动分账
默认为false
subOrders.[].profitShareTargets.[].manualSplitPayTypeNumber手动分账的支付类型
0 - 平台从订单收款方收账,再转给分账接收方,到达账期分账时将产生2笔线下支付;
1 - 订单收款方直接支付给分账接收方;
2 - 订单收款方直接支付给收分账接收方,且标记为已支付;
3 - 平台直接支付给收分账接收方,例如平台垫付优惠券成本等状况;
默认为0
subOrders.[].profitShareTargets.[].remarkString详细备注信息
与description不同,description用于提交到微信平台,remark用于保存详细的业务备注
subOrders.[].profitShareTargets.[].accountingDateString记账时间
用作与第三方对账时,与其会计期间匹配。
subOrders.[].profitShareTargets.[].targetTypeString帐户类型
由调用方根据分账方身份类型定义,例如:COMPANY,PARTNER,CHANNEL等
subOrders.[].profitShareTargets.[].targetIdStringtargetType下的帐户标识
subOrders.[].profitShareTargets.[].targetNameString帐户名
subOrders.[].goodsTagString订单优惠标记
subOrders.[].amountObject支付金额信息
subOrders.[].amount.totalNumber支付金额,单位为分
subOrders.[].amount.currencyString标价币种,符合ISO 4217标准的三位字母代码
CNY:人民币,境内商户号仅支持人民币
subOrders.[].detailObject优惠功能
subOrders.[].detail.costPriceNumber订单原价
1、商户侧一张小票订单可能被分多次支付,订单原价用于记录整张小票的交易金额。
2、当订单原价与支付金额不相等,则不享受优惠。
3、该字段主要用于防止同一张小票分多次支付,以享受多次优惠的情况,正常支付订单不必上传此参数。
subOrders.[].detail.invoiceIdString商家小票ID
subOrders.[].detail.goodsDetailObject[]单品列表信息
条目个数限制:【1,6000】
subOrders.[].detail.goodsDetail.[].merchantGoodsIdString商户侧商品编码
由半角的大小写字母、数字、中划线、下划线中的一种或几种组成。
subOrders.[].detail.goodsDetail.[].wechatpayGoodsIdString微信支付商品编码
微信支付定义的统一商品编号(没有可不传)
subOrders.[].detail.goodsDetail.[].goodsNameString商品的实际名称
subOrders.[].detail.goodsDetail.[].quantityNumber用户购买的数量
subOrders.[].detail.goodsDetail.[].unitPriceNumber商品单价
单位为:分。如果商户有优惠,需传输商户优惠后的单价(例如:用户对一笔100元的订单使用了商场发的纸质优惠券100-50,则活动商品的单价应为原单价-50)
subOrders.[].discountsObject[]订单使用的折扣信息
subOrders.[].discounts.[].idString折扣标识,如优惠券id
subOrders.[].discounts.[].typeString折扣类型,例如"coupon"
subOrders.[].discounts.[].nameString折扣名称,如折扣券名称
subOrders.[].discounts.[].amountNumber折扣金额,单位:分
subOrders.[].discounts.[].costNumber折扣券购买价格,单位:分
subOrders.[].discounts.[].refundNumber该折扣项涉及的退款金额,单位:分
subOrders.[].discounts.[].payerObject折扣出资方
subOrders.[].discounts.[].payer.targetTypeString帐户类型
由调用方根据分账方身份类型定义,例如:COMPANY,PARTNER,CHANNEL等
subOrders.[].discounts.[].payer.targetIdStringtargetType下的帐户标识
subOrders.[].discounts.[].payer.targetNameString帐户名
subOrders.[].discounts.[].extraObject其他扩展属性
subOrders.[].extraObject扩展信息,下游应用可以传递关联业务数据以便据此进行汇总统计
contextDataObject支付订单上下文信息,这些信息会在支付回调中被传递
supportFapiaoBoolean电子发票入口开放标识
传入true时,支付成功消息和支付详情页将出现开票入口。
需要在微信支付商户平台或微信公众平台开通电子发票功能,传此字段才可生效。
prepayIdString针对同一个订单重复支付时,提交之前返回的prepayId
sceneInfoObject支付场景描述
sceneInfo.payerClientIpString用户的客户端IP
支持IPv4和IPv6两种格式的IP地址。
sceneInfo.deviceIdString商户端设备号(门店号或收银设备ID)
sceneInfo.storeInfoObject商户门店信息
sceneInfo.storeInfo.idString商户侧门店编号
sceneInfo.storeInfo.nameString商户侧门店名称
sceneInfo.storeInfo.areaCodeString地区编码,详细请见省市区编号对照表。
sceneInfo.storeInfo.addressString详细的商户门店地址
isCreditBoolean是否记账(月结)账户

下载结果模型定义